mirror of
https://github.com/caddyserver/website.git
synced 2025-04-21 20:46:15 -04:00
docs: Add Windows service instructions (#176)
This commit is contained in:
parent
8fded0b38e
commit
275cce9403
1 changed files with 49 additions and 0 deletions
|
@ -29,6 +29,7 @@ This page describes various methods for installing Caddy on your system.
|
|||
- [Ansible](#ansible)
|
||||
- [Scoop](#scoop)
|
||||
- [Termux](#termux)
|
||||
- [Windows service](#windows-service)
|
||||
|
||||
|
||||
## Static binaries
|
||||
|
@ -223,3 +224,51 @@ _Note: This is a community-maintained installation method._
|
|||
|
||||
[**View the Termux build.sh file**](https://github.com/termux/termux-packages/blob/master/packages/caddy/build.sh)
|
||||
|
||||
|
||||
## Windows service
|
||||
|
||||
_Note: This is a community-maintained installation method._
|
||||
|
||||
Install Caddy as a service on Windows with these instructions.
|
||||
|
||||
**Requirements:**
|
||||
|
||||
- `caddy.exe` binary that you [downloaded](/download) or [built from source](/docs/build)
|
||||
- Any exe from the latest release of the
|
||||
[WinSW](https://github.com/winsw/winsw/releases/latest) service wrapper (Stay
|
||||
on a v2.x release for now)
|
||||
|
||||
Put all files into a service directory. In the following examples, we use `c:\caddy`.
|
||||
|
||||
Rename the WinSW exe file to `caddy-service.exe`.
|
||||
|
||||
Add a `caddy-service.xml` in the directory:
|
||||
|
||||
<pre><code class="cmd"><service>
|
||||
<id>caddy</id>
|
||||
<!-- Display name of the service -->
|
||||
<name>Caddy Web Server (powered by WinSW)</name>
|
||||
<!-- Service description -->
|
||||
<description>Caddy Web Server (https://caddyserver.com/)</description>
|
||||
<executable>%BASE%\caddy.exe</executable>
|
||||
<arguments>run</arguments>
|
||||
<log mode="roll-by-time">
|
||||
<pattern>yyyy-MM-dd</pattern>
|
||||
</log>
|
||||
</service>
|
||||
</code></pre>
|
||||
|
||||
You can now install the service using:
|
||||
<pre><code class="cmd">caddy-service install</code></pre>
|
||||
|
||||
You might want to start the Windows Services Console to see if the service is runnnig correctly:
|
||||
<pre><code class="cmd">services.msc</code></pre>
|
||||
|
||||
Be aware that Windows services cannot be reloaded, so you have to tell caddy directly to relaod:
|
||||
<pre><code class="cmd">caddy reload</code></pre>
|
||||
|
||||
Restarting is possible via the normal Windows services commands.
|
||||
|
||||
For customizing the service wrapper, see the [WinSW documentation](https://github.com/winsw/winsw/tree/master#usage)
|
||||
|
||||
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue