README.md (3707B)
1 About
2 -----
3
4 Kore (https://kore.io) is a web application platform for writing scalable,
5 concurrent web based processes in C or Python.
6
7 It is built with a "secure by default" approach. It is fully privilege
8 separated while using strong security features at the operating system level
9 such as seccomp, pledge, unveil and more.
10
11 Today Kore is used in a variety of applications ranging from high assurance
12 cryptographic devices, machine-learning stacks and even in the aerospace
13 industry.
14
15 From embedded platforms all the way to high performance servers. *Kore scales.*
16
17 Key Features
18 ------------
19 * Supports SNI
20 * Supports HTTP/1.1
21 * Websocket support
22 * Privseps by default
23 * TLS enabled by default
24 * Optional background tasks
25 * Built-in parameter validation
26 * Optional asynchronous PostgreSQL support
27 * Optional support for page handlers in Python
28 * Reload private keys and certificates on-the-fly
29 * Automatic X509 certificates via ACME (with privsep)
30 * Private keys isolated in separate process (RSA and ECDSA)
31 * Default sane TLS ciphersuites (PFS in all major browsers)
32 * Modules can be reloaded on-the-fly, even while serving content
33 * Worker processes sandboxed on OpenBSD (pledge) and Linux (seccomp)
34 * Event driven (epoll/kqueue) architecture with per CPU worker processes
35 * Build your web application as a precompiled dynamic library or single binary
36
37 And lots more.
38
39 License
40 -------
41 * Kore is licensed under the ISC license
42
43 Documentation
44 --------------
45 [Read the documentation](https://docs.kore.io/4.2.0/)
46
47 Performance
48 -----------
49 Read the [benchmarks](https://blog.kore.io/posts/benchmarks) blog post.
50
51 Platforms supported
52 -------------------
53 * Linux
54 * OpenBSD
55 * FreeBSD
56 * MacOS
57
58 Kore only supports x64, arm and aarch64 architectures.
59
60 Building Kore
61 -------------
62 Clone this repository or get the latest release at [https://kore.io/releases/4.2.3](https://kore.io/releases/4.2.3).
63
64 Requirements
65 * openssl 1.1.1, libressl 3.x or openssl 3.
66
67 Requirement for asynchronous curl (optional)
68 * libcurl (7.64.0 or higher)
69
70 Requirements for background tasks (optional)
71 * pthreads
72
73 Requirements for pgsql (optional)
74 * libpq
75
76 Requirements for python (optional)
77 * Python 3.6+
78
79 Requirements for lua support (optional)
80 * Lua 5.4+
81
82 Normal compilation and installation:
83
84 ```
85 $ cd kore
86 $ make
87 # make install
88 ```
89
90 If you would like to build a specific flavor, you can enable
91 those by setting a shell environment variable before running **_make_**.
92
93 * LUA=1 (compiles in LUA support)
94 * ACME=1 (compiles in ACME support)
95 * CURL=1 (compiles in asynchronous curl support)
96 * TASKS=1 (compiles in task support)
97 * PGSQL=1 (compiles in pgsql support)
98 * DEBUG=1 (enables use of -d for debug)
99 * NOHTTP=1 (compiles Kore without HTTP support)
100 * NOOPT=1 (disable compiler optimizations)
101 * JSONRPC=1 (compiles in JSONRPC support)
102 * PYTHON=1 (compiles in the Python support)
103 * TLS_BACKEND=none (compiles Kore without any TLS backend)
104
105 Note that certain build flavors cannot be mixed together and you will just
106 be met with compilation errors.
107
108 Example applications
109 -----------------
110 You can find example applications under **_examples/_**.
111
112 The examples contain a README file with instructions on how
113 to build or use them.
114
115 Mailing lists
116 -------------
117
118 **patches@kore.io** - Send patches here, preferably inline.
119
120 **users@kore.io** - Questions regarding kore.
121
122
123 If you want to signup to those mailing lists send an empty email to
124 listname+subscribe@kore.io
125
126
127 Other mailboxes (these are **not** mailing lists):
128
129 **security@kore.io** - Mail this email if you think you found a security problem.
130
131 **sponsor@kore.io** - If your company would like to sponsor part of Kore development.
132
133 More information can be found on https://kore.io/