Registry / devops / fontello-server

fontello-server

library1.1.29jsnpmunverified

A self-hosted CDN server for Fontello icon fonts, currently at version 1.1.29. It allows uploading Fontello zip files and config.json via drag-and-drop or HTTP API, then serves the fonts at hashed URLs. Fonts are persisted in LevelDB. It runs on port 2016 and supports Docker deployment. Compared to using Fontello directly, this provides offline/local hosting, versioning via hashes, and a simple API for integration into CI/CD pipelines. The project appears to be in maintenance mode with no recent updates.

devops web-framework

npm install fontello-server

github ↗package ↗

INSTALL

IMPORT

SIG · FONTELLO-SERVER

fontello-server

devopsjavascriptv1.1.29

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

server

✓ const server = require('fontello-server')

✗ import server from 'fontello-server'

This is a CommonJS module; ESM import will fail.

start

✓ server.start()

✗ server()

Exposes .start() method to launch the server.

default export

✓ const fontelloServer = require('fontello-server');

✗ import fontelloServer from 'fontello-server';

No default export; use require to get the whole module.

Starts the fontello server on port 2016 with a local LevelDB store.

const server = require('fontello-server'); server.start({ port: 2016, dbPath: './data', replCredentials: process.env.REPL_CREDENTIALS || '' }); console.log('fontello-server running on http://localhost:2016');

fontello-server --version

Debug

Known issues

deprecatedPackage has not been updated in years (last release 1.1.29). LevelDB and dependencies may have vulnerabilities.

fix

Consider migrating to an alternative font hosting solution or maintaining a fork.

affects: >=1.0.0

gotchaThe server only runs on port 2016 by default; cannot be changed without using Docker port mapping or modifying the code.

fix

Use Docker's -p option to map external port to 2016, or set environment variable PORT (if supported).

affects: >=1.0.0

gotchaUploading config.json via curl returns only the hash, not a JSON response. Some users expect JSON.

fix

Use curl -s to get the hash directly, or wrap in a script to capture output.

affects: >=1.0.0

gotchaDocker images are tagged with Node version (e.g., 6.9-alpine), which are outdated and insecure.

fix

Rebuild the Docker image or use a newer base image. Or avoid Docker usage entirely.

affects: >0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'leveldown'

Missing native dependency for LevelDB.

fix

Install leveldown: npm install leveldown

Error: listen EADDRINUSE :::2016

Port 2016 is already in use by another process.

fix

Stop the other process or change the port using Docker port mapping.

Error: connect ECONNREFUSED 127.0.0.1:2016

The fontello-server is not running.

fix

Start the server with `npm start` or using `node .` from the installation directory.

Upgrade

Version history

1.1.29latest on npm

Audit

Dependencies

leveldb-mountrequiredUsed to mount LevelDB for file system-like access.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/jameskyburz/fontello-server ↗

packagehttps://www.npmjs.com/package/fontello-server ↗