docker deploy

0. Requirements

Minimum 2G memory 2 CPU 64-bit Linux system

1. configure DNS

Configure A record in the domain name service provider or DNS resolution service provider

For example:

hostname

record type

record value

work

A

x.x.x.x

  • The hostname can be any secondary domain name prefix, here use work

  • example.com is your domain name

  • x.x.x.x is the public IP address of the server

  • The web access address is https://work.example.com

2. Install docker, docker-compose, git

# If already installed, skip

mkdir pkgs && cd pkgs
wget 'https://download.docker.com/linux/static/stable/x86_64/docker-26.1.4.tgz'
tar xf docker-26.1.4.tgz;
chmod +x docker/*
sudo cp docker/* /usr/local/bin/

curl -SL https://github.com/docker/compose/releases/download/v2.27.1/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose

yum install git # centos
apt install git  # ubuntu/debian

3. Install

git clone https://github.com/Hedwi/hedwi-docker.git
cd hedwi-docker/hedwi
cp env.example .env
# Modify the .env configuration, modify all variables marked with 'Need modify'

make  # After running, http 80 port can be accessed, should be able to access http://configured domain name

# The service will automatically create an administrator account (for configuring the system, adding users, adding teams, etc.) and a normal user account admin@your domain name (for using the system service)

config example <./env-example.html>`_

4. Automatic generation of free SSL certificates

# The service has built-in Let’s Encrypt HTTP-01 verification service interface, running this command will request the /acme/create interface to create a certificate
# After obtaining the certificate successfully, the certificate will be written to inbox/certs/cert.key inbox/certs/cert.crt
# This command will use the generated free certificate to replace nginx/certs/cert.key nginx/certs/cert.crt
make cert

5. Restart the service

make down # Stop all running docker containers
make # Start docker containers

6. Use https to access and login

Access https://work.example.com/login?admin=true (work.example.com is the domain name used), use the administrator account (the email and password configured) to log in Access https://work.example.com/hello page, continue to add users, teams, etc.