Install
- Download the latest version of Wiki.js:
wget https://github.com/Requarks/wiki/releases/download/2.5.170/wiki-js.tar.gz
- Extract the package to the final destination of your choice:
mkdir wiki
tar xzf wiki-js.tar.gz -C ./wiki
cd ./wiki
- Rename the sample config file to
config.yml
:
mv config.sample.yml config.yml
- Edit the config file and fill in your database and port settings (Configuration Reference):
nano config.yml
- For SQLite installations only: (skip this step otherwise) Fetch native bindings for SQLite3:
npm rebuild sqlite3
- Run Wiki.js
node server
- Wait until you are invited to open to the setup page in your browser.
- Complete the setup wizard to finish the installation.
Run as service
There are several solutions to run Wiki.js as a background service. We'll focus on systemd in this guide as it's available in nearly all linux distributions.
- Create a new file named
wiki.service
inside directory/etc/systemd/system
.
nano /etc/systemd/system/wiki.service
- Paste the following contents (assuming your wiki is installed at
/var/wiki
):
[Unit]
Description=Wiki.js
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always
# Consider creating a dedicated user for Wiki.js here:
User=nobody
Environment=NODE_ENV=production
WorkingDirectory=/var/wiki
[Install]
WantedBy=multi-user.target
- Save the service file (CTRL+X, followed by Y).
- Reload systemd:
systemctl daemon-reload
- Run the service:
systemctl start wiki
- Enable the service on system boot.
systemctl enable wiki
Note: You can see the logs of the service using journalctl -u wiki
configuration file demo:
# ---------------------------------------------------------------------
# Port the server should listen to
# ---------------------------------------------------------------------
port: 3000
# ---------------------------------------------------------------------
# Database
# ---------------------------------------------------------------------
# Supported Database Engines:
# - postgres = PostgreSQL 9.5 or later
# - mysql = MySQL 8.0 or later (5.7.8 partially supported, refer to docs)
# - mariadb = MariaDB 10.2.7 or later
# - mssql = MS SQL Server 2012 or later
# - sqlite = SQLite 3.9 or later
db:
type: postgres
# PostgreSQL / MySQL / MariaDB / MS SQL Server only:
host: localhost
port: 5432
user: wikijs
pass: wikijs
db: wiki
ssl: false
of course ,need to install and configure the postgresql and database ,reference the configuration ubove
tips: how to install node new version
ubuntu 安装指定版本nodejs(一次成功)
wget -qO- https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs