docsify/docs/deploy.md

Deploy

Similar to GitBook, you can deploy files to GitHub Pages, GitLab Pages or VPS.

GitHub Pages

There are three places to populate your docs for your GitHub repository:

• docs/ folder
• main branch
• gh-pages branch

It is recommended that you save your files to the ./docs subfolder of the main branch of your repository. Then select main branch /docs folder as your GitHub Pages source in your repository's settings page.

[!IMPORTANT] You can also save files in the root directory and select main branch. You'll need to place a .nojekyll file in the deploy location (such as /docs or the gh-pages branch)

GitLab Pages

If you are deploying your master branch, create a .gitlab-ci.yml with the following script:

[!TIP] The .public workaround is so cp doesn't also copy public/ to itself in an infinite loop.

pages:
  stage: deploy
  script:
  - mkdir .public
  - cp -r * .public
  - mv .public public
  artifacts:
    paths:
    - public
  only:
  - master

[!IMPORTANT] You can replace script with - cp -r docs/. public, if ./docs is your Docsify subfolder.

Firebase Hosting

[!IMPORTANT] You'll need to install the Firebase CLI using npm i -g firebase-tools after signing into the Firebase Console using a Google Account.

Using a terminal, determine and navigate to the directory for your Firebase Project. This could be ~/Projects/Docs, etc. From there, run firebase init and choose Hosting from the menu (use space to select, arrow keys to change options and enter to confirm). Follow the setup instructions.

Your firebase.json file should look similar to this (I changed the deployment directory from public to site):

{
  "hosting": {
    "public": "site",
    "ignore": ["firebase.json", "**/.*", "**/node_modules/**"]
  }
}

Once finished, build the starting template by running docsify init ./site (replacing site with the deployment directory you determined when running firebase init - public by default). Add/edit the documentation, then run firebase deploy from the root project directory.

VPS

Use the following nginx config.

server {
  listen 80;
  server_name  your.domain.com;

  location / {
    alias /path/to/dir/of/docs/;
    index index.html;
  }
}

Netlify

1. Login to your Netlify account.
2. In the dashboard page, click Add New Site.
3. Select GitHub.
4. Choose the repository where you store your docs, in the Base Directory add the subfolder where the files are stored. For example, it should be docs.
5. In the Build Command area leave it blank.
6. In the Publish directory area, if you have added the docs in the Base Directory you will see the publish directory populated with docs/
7. Netlify is smart enough to look for the the index.html file inside the docs/ folder.

HTML5 router

When using the HTML5 router, you need to set up redirect rules that redirect all requests to your index.html. It's pretty simple when you're using Netlify. Just create a file named _redirects in the docs directory, add this snippet to the file, and you're all set:

/*    /index.html   200

Vercel

1. Install Vercel CLI, npm i -g vercel
2. Change directory to your docsify website, for example cd docs
3. Deploy with a single command, vercel

AWS Amplify

1. Set the routerMode in the Docsify project index.html to history mode.

<script>
  window.$docsify = {
    loadSidebar: true,
    routerMode: 'history',
  };
</script>

2. Login to your AWS Console.
3. Go to the AWS Amplify Dashboard.
4. Choose the Deploy route to setup your project.
5. When prompted, keep the build settings empty if you're serving your docs within the root directory. If you're serving your docs from a different directory, customise your amplify.yml

version: 0.1
frontend:
  phases:
    build:
      commands:
        - echo "Nothing to build"
  artifacts:
    baseDirectory: /docs
    files:
      - '**/*'
  cache:
    paths: []

6. Add the following Redirect rules in their displayed order. Note that the second record is a PNG image where you can change it with any image format you are using.

Source address	Target address	Type
/<*>.md	/<*>.md	200 (Rewrite)
/<*>.png	/<*>.png	200 (Rewrite)
/<*>	/index.html	200 (Rewrite)

Stormkit

1. Login to your Stormkit account.
2. Using the user interface, import your docsify project from one of the three supported Git providers (GitHub, GitLab, or Bitbucket).
3. Navigate to the project’s production environment in Stormkit or create a new environment if needed.
4. Verify the build command in your Stormkit configuration. By default, Stormkit CI will run npm run build but you can specify a custom build command on this page.
5. Set output folder to docs
6. Click the “Deploy Now” button to deploy your site.

Read more in the Stormkit Documentation.

Docker

• Create docsify files

  You need prepare the initial files instead of making them inside the container. See the Quickstart section for instructions on how to create these files manually or using docsify-cli.

  index.html
  README.md
  

• Create Dockerfile

    FROM node:latest
    LABEL description="A demo Dockerfile for build Docsify."
    WORKDIR /docs
    RUN npm install -g docsify-cli@latest
    EXPOSE 3000/tcp
    ENTRYPOINT docsify serve .
  
  

  The current directory structure should be this:

   index.html
   README.md
   Dockerfile
  

• Build docker image

  docker build -f Dockerfile -t docsify/demo .
  

• Run docker image

  docker run -itp 3000:3000 --name=docsify -v $(pwd):/docs docsify/demo
  

Kinsta Static Site Hosting

You can deploy Docsify as a Static Site on Kinsta.

1. Login or create an account to view your MyKinsta dashboard.

2. Authorize Kinsta with your Git provider.

3. Select Static Sites from the left sidebar and press Add sites.

4. Select the repository and branch you want to deploy.

5. During the build settings, Kinsta will automatically try to fill out the Build command, Node version, and Publish directory. If it won't, fill out the following:

   • Build command: leave empty
   • Node version: leave on default selection or a specific version (e.g. 18.16.0)
   • Publish directory: docs

6. Click the Create site.

DeployHQ

DeployHQ is a deployment automation platform that deploys your code to SSH/SFTP servers, FTP servers, cloud storage (Amazon S3, Cloudflare R2), and modern hosting platforms (Netlify, Heroku).

[!IMPORTANT] DeployHQ does not host your site. It automates deploying your Docsify files to your chosen hosting provider or server.

To deploy your Docsify site using DeployHQ:

1. Sign up for a DeployHQ account and verify your email.

2. Create your first project by clicking on Projects and New Project. Connect your Git repository (GitHub, GitLab, Bitbucket, or any private repository). Authorize DeployHQ to access your repository.

3. Add a server and enter your server details:

   • Give your server a name
   • Select your protocol (SSH/SFTP, FTP, or cloud platform)
   • Enter your server hostname, username, and password/SSH key
   • Set Deployment Path to your web root (e.g., public_html/)

4. Since Docsify doesn't require a build step, you can deploy your files directly. If your Docsify files are in a docs/ folder, configure the Source Path in your server settings to docs/.

5. Click Deploy Project, then select your server and click Deploy to start your first deployment.

Your Docsify site will be deployed to your server. You can enable automatic deployments to deploy on every Git push, or schedule deployments for specific times.

For more information on advanced deployment features, see DeployHQ's documentation.