docker deploy¶
About¶
To be a nice google workspace alternative
0. Requirements¶
Minimum 1G memory 1 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)
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
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.