https://github.com/sc0tfree/updog

Updog is a replacement for Python's SimpleHTTPServer. It allows uploading and downloading via HTTP/S, can set ad hoc SSL certificates and use http basic auth.
https://github.com/sc0tfree/updog

file-sharing file-upload http-server https-server simplehttpserver

Last synced: 5 months ago
JSON representation

Updog is a replacement for Python's SimpleHTTPServer. It allows uploading and downloading via HTTP/S, can set ad hoc SSL certificates and use http basic auth.

• Host: GitHub
• URL: https://github.com/sc0tfree/updog
• Owner: sc0tfree
• License: mit
• Created: 2020-02-18T15:29:21.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-03-13T15:52:39.000Z (over 1 year ago)
• Last Synced: 2025-05-11T14:44:17.501Z (5 months ago)
• Topics: file-sharing, file-upload, http-server, https-server, simplehttpserver
• Language: Python
• Homepage:
• Size: 2.28 MB
• Stars: 3,066
• Watchers: 27
• Forks: 316
• Open Issues: 48
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![Version 1.4](http://img.shields.io/badge/version-v1.4-green.svg)

![Python 3.8](http://img.shields.io/badge/python-3.8-blue.svg)

[![MIT License](http://img.shields.io/badge/license-MIT%20License-blue.svg)](https://github.com/sc0tfree/updog/blob/master/LICENSE)

[![sc0tfree Twitter](http://img.shields.io/twitter/url/http/shields.io.svg?style=social&label=Follow)](https://twitter.com/sc0tfree)



  



Updog is a replacement for Python's `SimpleHTTPServer`. 

It allows uploading and downloading via HTTP/S, 

can set ad hoc SSL certificates and use HTTP basic auth.



  



## Installation

Install using pip:

`pip3 install updog`

## Usage

`updog [-d DIRECTORY] [-p PORT] [--password PASSWORD] [--ssl]`

| Argument                            | Description                                      |

|-------------------------------------|--------------------------------------------------| 

| -d DIRECTORY, --directory DIRECTORY | Root directory [Default=.]                       | 

| -p PORT, --port PORT                | Port to serve [Default=9090]                     |

| --password PASSWORD                 | Use a password to access the page. (No username) |

| --ssl                               | Enable transport encryption via SSL              |

| --version                           | Show version                                     |

| -h, --help                          | Show help                                        |

## Examples

**Serve from your current directory:**

`updog`

**Serve from another directory:**

`updog -d /another/directory`

**Serve from port 1234:**

`updog -p 1234`

**Password protect the page:**

`updog --password examplePassword123!`

*Please note*: updog uses HTTP basic authentication.

To login, you should leave the username blank and just

enter the password in the password field.

**Use an SSL connection:**

`updog --ssl`

## Thanks

A special thank you to [Nicholas Smith](http://nixmith.com) for

designing the updog logo.