https://github.com/taichunmin/docker-serveo

https://serveo.net is an alternative for ngrok. taichunmin/serveo can let you secure URL to your localhost server through any NAT or firewall in Docker. And taichunmin/serveo-server can let you host your own serveo.
https://github.com/taichunmin/docker-serveo

alpine docker docker-compose ngrok serveo

Last synced: 21 days ago
JSON representation

https://serveo.net is an alternative for ngrok. taichunmin/serveo can let you secure URL to your localhost server through any NAT or firewall in Docker. And taichunmin/serveo-server can let you host your own serveo.

• Host: GitHub
• URL: https://github.com/taichunmin/docker-serveo
• Owner: taichunmin
• License: mit
• Created: 2018-04-02T09:19:02.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2025-02-25T03:28:05.000Z (2 months ago)
• Last Synced: 2025-03-30T03:11:03.701Z (28 days ago)
• Topics: alpine, docker, docker-compose, ngrok, serveo
• Language: Dockerfile
• Homepage: https://hub.docker.com/r/taichunmin/serveo/
• Size: 9.77 KB
• Stars: 110
• Watchers: 5
• Forks: 16
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![GitHub stars](https://img.shields.io/github/stars/taichunmin/docker-serveo.svg)](https://github.com/taichunmin/docker-serveo/stargazers)

[![GitHub license](https://img.shields.io/github/license/taichunmin/docker-serveo.svg)](https://github.com/taichunmin/docker-serveo/blob/master/LICENSE)

![Docker Stars](https://img.shields.io/docker/stars/taichunmin/serveo.svg)

![Docker Pulls](https://img.shields.io/docker/pulls/taichunmin/serveo.svg)

[![Build status](https://img.shields.io/github/actions/workflow/status/taichunmin/docker-serveo/dockerhub.yml?branch=master)](https://github.com/taichunmin/docker-serveo/actions/workflows/dockerhub.yml)

# docker for serveo.net

[https://serveo.net](https://serveo.net) is an alternative for ngrok. [taichunmin/serveo](https://hub.docker.com/r/taichunmin/serveo) can let you secure URL to your localhost server through any NAT or firewall in Docker. And [taichunmin/serveo-server](https://hub.docker.com/r/taichunmin/serveo-server) can let you host your own serveo.

## Usage

1. write a `docker-compose.yml` file.

```yml

version: '2'

services:

  serveo:

    image: taichunmin/serveo:latest

    tty: true

    stdin_open: true

    command: >

      autossh -M 0

      -o ServerAliveInterval=60

      -o ServerAliveCountMax=3

      -o ExitOnForwardFailure=yes

      -o StrictHostKeyChecking=no

      -R 80:nginx:80

      serveo.net

  nginx:

    image: nginx:latest

```

2. use `docker-compose up -d` to start container.

3. you need to use `docker-compose logs serveo` to see your new URL.

4. For more options, see [serveo.net](https://serveo.net) or [serveo.net backup](./serveo.net.md).

## Demo

```bash

$ git clone https://github.com/taichunmin/docker-serveo.git

$ sudo docker-compose up -d

$ sudo docker-compose logs serveo

Attaching to dockerserveo_serveo_1

serveo_1  | Warning: Permanently added 'serveo.net,195.201.91.242' (RSA) to the list of known hosts.

serveo_1  | Forwarding HTTP traffic from https://proinde.serveo.net

serveo_1  | Press g to start a GUI session and ctrl-c to quit.

```

## LICENSE

MIT License