docs: simplify self-hosting deploy docs

- Remove hidden CLI flags from docs (--load, --push, --network)
- Clarify that v4 self-hosted builds are local by default
- Remove deprecated --self-hosted flag from examples
- Reference GitHub Actions guide for CI setup
- Simplify GitHub Actions self-hosting example

Fixes #2835

Author: claude

docs/github-actions.mdx

@@ -134,16 +134,11 @@ You should use the version you run locally during dev and manual deploy. The cur
 
 ## Self-hosting
 
-When self-hosting, you will have to take a few additional steps:
+When self-hosting, you need to:
 
-- Specify the `TRIGGER_API_URL` environment variable. You can add it to the GitHub secrets the same way as the access token. This should point at your webapp domain, for example: `https://trigger.example.com`
-- Setup docker as you will need to build and push the image to your registry. On [Trigger.dev Cloud](https://cloud.trigger.dev) this is all done remotely.
+- Set up Docker Buildx in your CI environment for building images locally.
 - Add your registry credentials to the GitHub secrets.
-- Use the `--self-hosted` and `--push` flags when deploying.
-
-<Tip>If you're self-hosting v4, the `--self-hosted` and `--push` flags are **NOT** needed.</Tip>
-
-Other than that, your GitHub action file will look very similar to the one above:
+- Specify the `TRIGGER_API_URL` environment variable pointing to your webapp domain, for example: `https://trigger.example.com`
 
 <CodeGroup>
 
@@ -170,13 +165,11 @@ jobs:
       - name: Install dependencies
         run: npm install
 
-      # docker setup - part 1
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
         with:
           version: latest
 
-      # docker setup - part 2
       - name: Login to DockerHub
         uses: docker/login-action@v3
         with:
@@ -186,11 +179,9 @@ jobs:
       - name: 🚀 Deploy Trigger.dev
         env:
           TRIGGER_ACCESS_TOKEN: ${{ secrets.TRIGGER_ACCESS_TOKEN }}
-          # required when self-hosting
           TRIGGER_API_URL: ${{ secrets.TRIGGER_API_URL }}
-        # deploy with additional flags
         run: |
-          npx trigger.dev@latest deploy --self-hosted --push
+          npx trigger.dev@latest deploy
 ```
 
 </CodeGroup>

docs/snippets/cli-commands-deploy.mdx

@@ -85,54 +85,14 @@ These options are available on most commands.
 
 ### Self-hosting
 
-These options are used when [self-hosting](/open-source-self-hosting) or for local development.
-
-<ParamField body="Local build" type="--local-build">
-  Build the deployment image locally using your local Docker instead of using the remote build service.
-</ParamField>
-
-<ParamField body="Load image" type="--load">
-  Load the built image into your local Docker after building it.
-</ParamField>
-
-<ParamField body="Push image" type="--push">
-  Push the image to the registry after building locally.
-</ParamField>
-
-<ParamField body="Network" type="--network">
-  The networking mode for RUN instructions when building locally. Options: `default`, `none`, `host`.
-</ParamField>
-
-<ParamField body="Native build server" type="--native-build-server">
-  Use the native build server for building the image. This uploads your project files and builds remotely.
-</ParamField>
-
-<ParamField body="Detach" type="--detach">
-  Return immediately after the deployment is queued, without waiting for the build to complete. Implies `--native-build-server`.
-</ParamField>
-
-## Examples
-
-### Self-hosted deployment
-
-For self-hosted deployments, set your `TRIGGER_ACCESS_TOKEN` and use the `--api-url` option to point to your self-hosted instance:
+When [self-hosting](/open-source-self-hosting), builds are performed locally by default. Set the `TRIGGER_ACCESS_TOKEN` environment variable and point to your self-hosted instance using `TRIGGER_API_URL` or `--api-url`:
 
 ```bash
-TRIGGER_ACCESS_TOKEN=your_token npx trigger.dev@latest deploy --api-url https://your-trigger-instance.com
+TRIGGER_ACCESS_TOKEN=your_token TRIGGER_API_URL=https://your-trigger-instance.com npx trigger.dev@latest deploy
 ```
 
-### Local build with Docker
-
-Build the image locally and load it into your local Docker:
-
-```bash
-npx trigger.dev@latest deploy --local-build --load
-```
+For CI/CD setup with self-hosting, see the [GitHub Actions guide](/github-actions#self-hosting).
 
-### Local build and push to registry
-
-Build the image locally and push it to your configured registry:
-
-```bash
-npx trigger.dev@latest deploy --local-build --push
-```
+<ParamField body="Local build" type="--local-build">
+  Force building the deployment image locally using your local Docker. This is automatic when self-hosting.
+</ParamField>