1# Restart Command
2
3Restart a running container for a route.
4
5## gordon restart
6
7### Synopsis
8
9```bash
10gordon restart <domain> [options]
11```
12
13### Arguments
14
15| Argument | Description |
16|----------|-------------|
17| `<domain>` | The route domain to restart |
18
19### Options
20
21| Option | Description |
22|--------|-------------|
23| `--with-attachments` | Also restart attached services (databases, caches) |
24| `--remote, -r` | Remote name or URL (e.g., prod, https://gordon.mydomain.com) |
25| `--token` | Authentication token for remote |
26
27### Description
28
29Restarts the container for the specified route. This is useful after updating
30environment variables or secrets without performing a full redeploy.
31
32When `--with-attachments` is set, Gordon also restarts any attachment containers
33for the route.
34
35### Examples
36
37```bash
38# Restart main container only
39gordon restart myapp.example.com
40
41# Restart with attachments
42gordon restart myapp.example.com --with-attachments
43```
44
45### Notes
46
47- Local mode works when run on the Gordon host. It uses the same deploy-signal path as `gordon deploy <domain>`.
48- `--with-attachments` is only supported in remote mode.
49- In remote mode, target your Gordon admin endpoint (for example `https://gordon.example.com`), not the registry host (for example `https://reg.example.com`).
50
51## Related
52
53- [CLI Overview](./index.md)
54- [Secrets Command](./secrets.md)