1
0
mirror of https://git.kore.io/kore.git synced 2024-11-07 19:13:13 +01:00
Go to file
2024-10-25 12:13:55 +02:00
conf Allow authenticators on filemaps. 2022-08-10 10:13:01 +02:00
examples Add missing inttypes header 2023-04-06 09:23:43 +02:00
include/kore remove const from kore_runtime_count(). 2023-11-03 12:25:39 +01:00
kodev make sure we add to LDFLAGS 2021-10-27 17:59:14 +02:00
misc sync syscall lists from linux 2023-09-07 11:10:50 +02:00
src Make it safe to call timer close method from timer callback. 2024-10-25 12:12:38 +02:00
tools/kore-serve Be better. 2022-08-10 10:20:18 +02:00
.gitignore Add seccomp syscall filtering to kore. 2019-09-25 14:31:20 +02:00
BEERS up the beer counter 2024-10-25 12:13:55 +02:00
LICENSE i forgot, it's 2022. 2022-01-31 22:02:06 +01:00
Makefile Allow setting of LUA_VERSION for pkg-config. 2023-01-23 21:33:11 +01:00
minisign.pub add minisign public key 2018-07-09 07:42:18 +02:00
README.md mention lua in readme 2023-01-23 21:34:22 +01:00
RELEASE.md rename RELEASE to RELEASE.md 2022-04-20 11:37:58 +02:00

About

Kore (https://kore.io) is a web application platform for writing scalable, concurrent web based processes in C or Python.

It is built with a "secure by default" approach. It is fully privilege separated while using strong security features at the operating system level such as seccomp, pledge, unveil and more.

Today Kore is used in a variety of applications ranging from high assurance cryptographic devices, machine-learning stacks and even in the aerospace industry.

From embedded platforms all the way to high performance servers. Kore scales.

Key Features

  • Supports SNI
  • Supports HTTP/1.1
  • Websocket support
  • Privseps by default
  • TLS enabled by default
  • Optional background tasks
  • Built-in parameter validation
  • Optional asynchronous PostgreSQL support
  • Optional support for page handlers in Python
  • Reload private keys and certificates on-the-fly
  • Automatic X509 certificates via ACME (with privsep)
  • Private keys isolated in separate process (RSA and ECDSA)
  • Default sane TLS ciphersuites (PFS in all major browsers)
  • Modules can be reloaded on-the-fly, even while serving content
  • Worker processes sandboxed on OpenBSD (pledge) and Linux (seccomp)
  • Event driven (epoll/kqueue) architecture with per CPU worker processes
  • Build your web application as a precompiled dynamic library or single binary

And lots more.

License

  • Kore is licensed under the ISC license

Documentation

Read the documentation

Performance

Read the benchmarks blog post.

Platforms supported

  • Linux
  • OpenBSD
  • FreeBSD
  • MacOS

Kore only supports x64, arm and aarch64 architectures.

Building Kore

Clone this repository or get the latest release at https://kore.io/releases/4.2.3.

Requirements

  • openssl 1.1.1, libressl 3.x or openssl 3.

Requirement for asynchronous curl (optional)

  • libcurl (7.64.0 or higher)

Requirements for background tasks (optional)

  • pthreads

Requirements for pgsql (optional)

  • libpq

Requirements for python (optional)

  • Python 3.6+

Requirements for lua support (optional)

  • Lua 5.4+

Normal compilation and installation:

$ cd kore
$ make
# make install

If you would like to build a specific flavor, you can enable those by setting a shell environment variable before running make.

  • LUA=1 (compiles in LUA support)
  • ACME=1 (compiles in ACME support)
  • CURL=1 (compiles in asynchronous curl support)
  • TASKS=1 (compiles in task support)
  • PGSQL=1 (compiles in pgsql support)
  • DEBUG=1 (enables use of -d for debug)
  • NOHTTP=1 (compiles Kore without HTTP support)
  • NOOPT=1 (disable compiler optimizations)
  • JSONRPC=1 (compiles in JSONRPC support)
  • PYTHON=1 (compiles in the Python support)
  • TLS_BACKEND=none (compiles Kore without any TLS backend)

Note that certain build flavors cannot be mixed together and you will just be met with compilation errors.

Example applications

You can find example applications under examples/.

The examples contain a README file with instructions on how to build or use them.

Mailing lists

patches@kore.io - Send patches here, preferably inline.

users@kore.io - Questions regarding kore.

If you want to signup to those mailing lists send an empty email to listname+subscribe@kore.io

Other mailboxes (these are not mailing lists):

security@kore.io - Mail this email if you think you found a security problem.

sponsor@kore.io - If your company would like to sponsor part of Kore development.

More information can be found on https://kore.io/