Sign inSign up

padloc/server

By padloc

•Updated almost 3 years ago

Padloc Server Image

Image
4

50K+

padloc/server repository overview

⁠Padloc

Simple, secure password and data management for individuals and teams (formerly known as Padlock).

This repo is split into multiple packages:

Package NameDescription
@padloc/core⁠Core Logic
@padloc/app⁠Web-based UI components
@padloc/server⁠The Backend Server
@padloc/pwa⁠The Web Client, a Progressive Web App⁠ built on top of the @padloc/app package
@padloc/locale⁠Package containing translations and other localization-related things
@padloc/electron⁠The Desktop App, built with Electron
@padloc/cordova⁠Cordova project for building iOS and Android app.
@padloc/tauri (experimental)⁠Cross-platform native app builder for Padloc, powered by Tauri⁠

⁠Getting Started

⁠Step 0: Install Prerequisites

You'll need

⁠Step 1: Clone the Repo
git clone https://github.com/padloc/padloc
cd padloc
⁠Step 2: Install Dependencies
npm install
⁠Step 3: Start Server and Web Client
PL_DATA_DIR=~/padloc-data \
PL_SERVER_PORT=3000 \
PL_PWA_PORT=8080 \
npm run start

For more configuration options, see Configuration⁠

⁠Scripts

CommandDescription
npm startStarts both backend server and web client.
npm run server:startStarts only backend server.
npm run pwa:startStarts only web client (You'll need to run npm run pwa:build first).
npm run pwa:buildBuilds the web client
npm run devStarts backend server and client app in dev mode, which watches for changes in the source files and automatically rebuilds/restarts the corresponding components.
npm testRun tests.

⁠Configuration

Environment VariableDefaultDescription
PL_SERVER_PORT3000Which port to host the backend server on
PL_SERVER_URLhttp://0.0.0.0:$PL_SERVER_PORTPublic URL that will resolve to the backend server. Used by clients to send requests.
PL_PWA_PORT8080Which port to host the web client on
PL_PWA_URLhttp://0.0.0.0:$PL_PWA_PORTPublic URL that will resolve to the web client. Used by the server to generate links into the web client.
PL_PWA_DIR./packages/pwa/distBuild directory for web client.
PL_DATA_DIR./dataDirectory used by server for persistent data storage
PL_ATTACHMENTS_DIR./attachmentsDirectory used by server to store attachments
PL_LOGS_DIR./logsDirectory used by server to store logs
PL_EMAIL_USER-SMTP user for sending emails.
PL_EMAIL_SERVER-SMTP server for sending emails
PL_EMAIL_PORT-SMTP port for sending emails
PL_EMAIL_SECUREfalseSMTP use secured connection for sending emails
PL_EMAIL_PASSWORD-SMTP password for sending email
PL_REPORT_ERRORS-Email address used for reporting unexpected errors in the backend.

⁠Security

For a security design overview, check out the security whitepaper⁠.

Tag summary

Content type

Image

Digest

sha256:cee4d7fc7…

Size

641.3 MB

Last updated

almost 3 years ago

docker pull padloc/server