Create README.md
This commit is contained in:
		
							parent
							
								
									d026c0ff4a
								
							
						
					
					
						commit
						679dfb39e8
					
				|  | @ -0,0 +1,58 @@ | ||||||
|  | # wireguard-ui | ||||||
|  | A web user interface to manage your WireGuard setup. | ||||||
|  | 
 | ||||||
|  | ## Features | ||||||
|  | - Friendly UI | ||||||
|  | - Authentication | ||||||
|  | - Manage extra client's information (name, email, etc) | ||||||
|  | - Retrieve configs using QR code / file | ||||||
|  | 
 | ||||||
|  | ## Run WireGuard-UI | ||||||
|  | Only docker option for now, please refer to this example of [docker-compose.yml](https://github.com/ngoduykhanh/wireguard-ui/blob/master/docker-compose.yaml). | ||||||
|  | 
 | ||||||
|  | Please adjust volume mount points to work with your setup. Then run it: | ||||||
|  | 
 | ||||||
|  | ``` | ||||||
|  | docker-compose up | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | ## Auto restart WireGuard daemon | ||||||
|  | WireGuard-UI only takes care of configuration generation. You can use systemd to watch for the changes and restart the service. Following is an example: | ||||||
|  | 
 | ||||||
|  | Create /etc/systemd/system/wgui.service | ||||||
|  | 
 | ||||||
|  | ``` | ||||||
|  | [Unit] | ||||||
|  | Description=Restart WireGuard | ||||||
|  | After=network.target | ||||||
|  | 
 | ||||||
|  | [Service] | ||||||
|  | Type=oneshot | ||||||
|  | ExecStart=/usr/bin/systemctl restart wg-quick@wg0.service | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | Create /etc/systemd/system/wgui.path | ||||||
|  | 
 | ||||||
|  | ``` | ||||||
|  | [Unit] | ||||||
|  | Description=Watch /etc/wireguard/wg0.conf for changes | ||||||
|  | 
 | ||||||
|  | [Path] | ||||||
|  | PathModified=/etc/wireguard/wg0.conf | ||||||
|  | 
 | ||||||
|  | [Install] | ||||||
|  | WantedBy=multi-user.target | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | Apply it | ||||||
|  | ``` | ||||||
|  | systemctl enable wgui.{path,service} | ||||||
|  | systemctl start wgui.{path,service} | ||||||
|  | ``` | ||||||
|  | 
 | ||||||
|  | ## Screenshot | ||||||
|  | 
 | ||||||
|  |  | ||||||
|  | 
 | ||||||
|  | ## License | ||||||
|  | MIT. See [LICENSE](https://github.com/ngoduykhanh/wireguard-ui/blob/master/LICENSE). | ||||||
		Loading…
	
		Reference in New Issue