Deployment

Deploy your Doks site to Netlify or any other static web host.

On this page

👉

Make sure to set baseURL in ./config/production/config.toml to the URL of your Doks website in production.

Deploy to Netlify

See Netlify.

Deploy to GitHub Pages

💡

Check the example repo showing how to publish to GitHub Pages.

  1. Add .github/workflows/deploy-github.yml:
  1. # Deploy your Hyas site to GitHub Pages
  3. name: GitHub Pages
  5. on:
  6.   push:
  7.     branches:
  8.       - master
  10. jobs:
  11.   deploy:
  12.     runs-on: ubuntu-20.04
  13.     steps:
  14.       - uses: actions/checkout@v2
  15.       - uses: actions/setup-node@v2
  16.         with:
  17.           node-version: '16'
  18.           cache: 'npm'
  20.       - name: Install dependencies
  21.         run: npm install
  23.       - name: Check for linting errors
  24.         run: npm test
  26.       - name: Build production website
  27.         run: npm run build
  29.       - name: Deploy to GitHub Pages
  30.         uses: peaceiris/actions-gh-pages@v3
  31.         with:
  32.           github_token: ${{ secrets.GITHUB_TOKEN }}
  33.           publish_dir: ./public
  1. Click on the Actions tab of your GitHub repo and wait for the action to finish successfully (after approximately 30 seconds).

Select branch

  1. Go to the Settings tab of your GitHub repo, and next to the Pages section. Select branch gh-pages and click Save.
  2. Copy the Your site is published at URL and paste it as baseurl in ./config/production/config.toml.
  3. Set canonifyURLs = true in ./config/production/config.toml.
  4. Push the changes to GitHub and wait for the action to finish successfully (after approximately 30 seconds).
  5. That’s it. After a minute or so, you site is available at the Your site is published at URL.

Now, after every push to the master branch, your site will be updated — automatically.

Deploy to other hosts

See the Hugo Docs: Hosting & Deployment.